home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / ifl / TIFFWriteDirectory.z / TIFFWriteDirectory
Text File  |  1998-10-20  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4. TTTTIIIIFFFFFFFFWWWWrrrriiiitttteeeeDDDDiiiirrrreeeeccccttttoooorrrryyyy((((3333TTTT))))               IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      TIFFWriteDirectory - write the current directory in an open TIFF file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ttttiiiiffffffffiiiioooo....hhhh>>>>
  13.      iiiinnnntttt TTTTIIIIFFFFFFFFWWWWrrrriiiitttteeeeDDDDiiiirrrreeeeccccttttoooorrrryyyy((((TTTTIIIIFFFFFFFF**** ttttiiiiffff))))
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      Write the contents of the current directory to the file and setup to
  17.      create a new subfile in the same file.  Applications only need to call
  18.      _T_I_F_F_W_r_i_t_e_D_i_r_e_c_t_o_r_y when writing multiple subfiles to a single TIFF file.
  19.      _T_I_F_F_W_r_i_t_e_D_i_r_e_c_t_o_r_y is automatically called by _T_I_F_F_C_l_o_s_e and _T_I_F_F_F_l_u_s_h to
  20.      write a modified directory if the file is open for writing.
  21.  
  22. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
  23.      1 is returned when the contents are successfully written to the file.
  24.      Otherwise, 0 is returned if an error was encountered when writing the
  25.      directory contents.
  26.  
  27. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  28.      All error messages are directed to the _T_I_F_F_E_r_r_o_r(3T) routine.
  29.  
  30.      EEEErrrrrrrroooorrrr ppppoooosssstttt----eeeennnnccccooooddddiiiinnnngggg bbbbeeeeffffoooorrrreeee ddddiiiirrrreeeeccccttttoooorrrryyyy wwwwrrrriiiitttteeee.  Before writing the contents
  31.      of the current directory, any pending data are flushed.  This message
  32.      indicates that an error occurred while doing this.
  33.  
  34.      EEEErrrrrrrroooorrrr fffflllluuuusssshhhhiiiinnnngggg ddddaaaattttaaaa bbbbeeeeffffoooorrrreeee ddddiiiirrrreeeeccccttttoooorrrryyyy wwwwrrrriiiitttteeee.  Before writing the contents
  35.      of the current directory, any pending data are flushed.  This message
  36.      indicates that an error occurred while doing this.
  37.  
  38.      CCCCaaaannnnnnnnooootttt wwwwrrrriiiitttteeee ddddiiiirrrreeeeccccttttoooorrrryyyy,,,, oooouuuutttt ooooffff ssssppppaaaacccceeee.  There was not enough space to
  39.      allocate a temporary area for the directory that was to be written.
  40.  
  41.      EEEErrrrrrrroooorrrr wwwwrrrriiiittttiiiinnnngggg ddddiiiirrrreeeeccccttttoooorrrryyyy ccccoooouuuunnnntttt.  A write error occurred when writing the
  42.      count of fields in the directory.
  43.  
  44.      EEEErrrrrrrroooorrrr wwwwrrrriiiittttiiiinnnngggg ddddiiiirrrreeeeccccttttoooorrrryyyy ccccoooonnnntttteeeennnnttttssss.  A write error occurred when writing
  45.      the directory fields.
  46.  
  47.      EEEErrrrrrrroooorrrr wwwwrrrriiiittttiiiinnnngggg ddddiiiirrrreeeeccccttttoooorrrryyyy lllliiiinnnnkkkk.  A write error occurred when writing the
  48.      link to the next directory.
  49.  
  50.      EEEErrrrrrrroooorrrr wwwwrrrriiiittttiiiinnnngggg ddddaaaattttaaaa ffffoooorrrr ffffiiiieeeelllldddd """"%%%%ssss"""".  A write error occurred when writing
  51.      indirect data for the specified field.
  52.  
  53.      EEEErrrrrrrroooorrrr wwwwrrrriiiittttiiiinnnngggg TTTTIIIIFFFFFFFF hhhheeeeaaaaddddeeeerrrr.  A write error occurred when re-writing header
  54.      at the front of the file.
  55.  
  56.      EEEErrrrrrrroooorrrr ffffeeeettttcccchhhhiiiinnnngggg ddddiiiirrrreeeeccccttttoooorrrryyyy ccccoooouuuunnnntttt.  A read error occurred when fetching the
  57.      directory count field for a previous directory.  This can occur when
  58.      setting up a link to the directory that is being written.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TTTTIIIIFFFFFFFFWWWWrrrriiiitttteeeeDDDDiiiirrrreeeeccccttttoooorrrryyyy((((3333TTTT))))               IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll
  71.  
  72.  
  73.  
  74.      EEEErrrrrrrroooorrrr ffffeeeettttcccchhhhiiiinnnngggg ddddiiiirrrreeeeccccttttoooorrrryyyy lllliiiinnnnkkkk.  A read error occurred when fetching the
  75.      directory link field for a previous directory.  This can occur when
  76.      setting up a link to the directory that is being written.
  77.  
  78. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  79.      _l_i_b_t_i_f_f(3T), _T_I_F_F_O_p_e_n(3T), _T_I_F_F_E_r_r_o_r(3T), _T_I_F_F_R_e_a_d_D_i_r_e_c_t_o_r_y(3T),
  80.      _T_I_F_F_S_e_t_D_i_r_e_c_t_o_r_y(3T)
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.